home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1995 May / macformat-024.iso / Shareware City / Utilities / Greg's Buttons 3.5.3 folder / Greg's Buttons Docs next >
Encoding:
Text File  |  1995-01-05  |  17.6 KB  |  337 lines  |  [ttro/ttxt]
  1. •••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
  2. Greg's Buttons 3.5.3 (12 January 1995)      ©1991-95 Gregory D. Landweber
  3. Internet: greg@math.harvard.edu                                 ALL RIGHTS RESERVED
  4. CompuServe: 73131,3326                     REGISTRATION FEE: US $15 or UK £10
  5. •••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
  6.  
  7. PLEASE READ THIS FILE BEFORE SENDING ME QUESTIONS OR BUG REPORTS!
  8.  
  9. Greg's Buttons is a control panel that lets you customize the user interface
  10. of a Macintosh running System 7™. Greg's Buttons requires that your Mac
  11. support color, so it won't work on the Plus, SE, Classic, or PowerBook 100.
  12. It works fine with both color and gray-scale monitors, and although it will
  13. still work on a black and white screen, the effect won't be as impressive.
  14.  
  15. Greg's Buttons is a "fat binary", containing both 680x0 and PowerPC native
  16. code for optimal performance on Macintosh and Power Macintosh computers
  17. The PowerPC code takes up only 15K on your hard disk, and it is not loaded
  18. into RAM on a 680x0 Macintosh. The section "ResEdit Hacking" below gives
  19. instructions for trimming the PowerPC code.
  20.  
  21. TO DISABLE THE "ANNOYING SHAREWARE MESSAGE", JUST UNCHECK THE
  22. "ANNOYING SHAREWARE MESSAGE" BOX IN THE MAIN CONTROL PANEL. THIS
  23. DOES NOT REQUIRE A PASSWORD OR REGISTRATION CODE. I TRUST YOU!
  24.  
  25. LIST OF FEATURES
  26. =================
  27. •    Replaces the standard flat black and white push buttons, check boxes, and
  28.     radio buttons with tasteful 3D color ones. These buttons are designed to
  29.     complement the windows and scroll bars in the System 7 interface, and in
  30.     particular they use the color tints that you can select in the "Color"
  31.     control panel. You can choose from two styles of push buttons and three
  32.     styles each of radio buttons and check boxes. There is also an option to
  33.     draw the text of push buttons using an "embossed" style.
  34.  
  35. •    Substitutes a font of your choice (chosen from two versions each of
  36.     Helvetica, Espi, and Palatino) for Chicago as your system font. This
  37.     font is used in menus, window titles, dialogs, and several other places
  38.     throughout the Mac interface. Note that this feature changes more than
  39.     just the menu font. Also note that this feature has nothing to do with
  40.     the "Views" control panel, which changes the font in Finder™ windows.
  41.  
  42. •    Lets you select the background color of dialog boxes, menus (both the
  43.     text and background colors), and Finder™ windows. Since the dialog box
  44.     colorization feature is known to cause some unavoidable conflicts,
  45.     there is an "Exclude Applications…" button which lets you specify
  46.     applications in which the dialog boxes should not be colorized.
  47.  
  48. •  If you have Macintosh Easy Open or Hardware System Update 3.0, then
  49.     you may have noticed that the new small icons in the Open... and Save...
  50.     boxes are in color in some applications and black and white in others.
  51.     When the dialog box background color feature of Greg's Buttons is
  52.     turned on, these small icons will always be drawn in color (except in
  53.     the excluded applications). If you want color small icons but are not
  54.     partial to color dialog backgrounds, you can set the color to white.
  55.  
  56. •    Colorizes the mini icons in Finder™ list views (i.e., view by name, etc.).
  57.     (This feature is enabled only under Systems 7.0, 7.0.1 or 7.1.)
  58.  
  59. •    Colorizes the stop sign, caution, and note alert icons.
  60.  
  61. CHANGES SINCE v3.5.2
  62. ====================
  63. •  Added the new substitute system font "Tecton 14".
  64.  
  65. CHANGES SINCE v3.5.1
  66. ====================
  67. •  Added the new substitute system font "Tecton 12".
  68.  
  69. RESEDIT HACKING
  70. =================
  71. If you are using Greg's Buttons on a 680x0-based Macintosh, you can chop
  72. out the PowerPC code to save yourself 15k of disk space. All you need to
  73. do is open up a COPY of Greg's Buttons (I cannot stress this enough since
  74. the active Greg's Buttons file can become corrupted if you open it with
  75. ResEdit) and remove the resource "PACH" #129 named "PowerPC Patches"
  76. and the resource "CDEF" #99 named "PowerPC Buttons".
  77.  
  78. The resulting lobotomized version will still run on a PowerMac; it will just
  79. use the existing 680x0 code under emulation. I don't know why anybody
  80. would want to do this, but I expected someone would ask.
  81.  
  82. Please note that you should NOT under any circumstances remove any other
  83. resources from the Greg's Buttons file. In some cases, Greg's Buttons would
  84. be clever enough to recognize such tampering and turn the relevant features
  85. off; in other cases, it might just crash.
  86.  
  87. KNOWN PROBLEMS
  88. =================
  89. Greg's Buttons does some serious fiddling with the Mac user interface.
  90. Applications often make invalid assumptions about their operating
  91. environment which no longer hold when you customize your Mac.  Since the
  92. programmers did not forsee these changes, and since they never had the
  93. opportunity to test their products with Greg's Buttons,  there are bound to
  94. be some conflicts.  In most cases, these are not the fault of Greg's Buttons,
  95. but if I find out about them, I will try my best to work around such
  96. problems.  Here are some of the most common examples:
  97.  
  98. PlainTalk
  99. ---------
  100. •  I am told that Greg's Buttons disables PlainTalk voice recognition in
  101.     some dialog boxes. I have tried to solve this problem, but I couldn't
  102.     figure out what was going wrong or how to work around it.
  103.  
  104. Ritz Software
  105. -------------
  106. •  The "System 7 Color Buttons" feature conflicts with the programs from
  107.     Ritz Software Ltd. This is a due to a bug in their software, not mine,
  108.     and I have spoken with them, explaining how they can fix it.
  109.  
  110. MasterJuggler
  111. -------------
  112. •  The "Substitute System Font" feature will not function properly with
  113.     MasterJuggler version 1.57c or earlier, but it should work fine with
  114.     version 1.58. Contact ALSoft for an upgrade.
  115.  
  116. Directory Assistance II
  117. ----------------------
  118. •  I am told that Directory Assistance II prevents Greg's Buttons from
  119.     colorizing the "New Folder..." button in the "Save as..." dialog box.
  120.     It seems that Directory Assistance II is overriding the normal button
  121.     drawing routines and is substituting its own custom black and white
  122.     version. I am afraid that there is nothing I can do about this.  Sorry.
  123.  
  124. theTypeBook
  125. ------------
  126. •  When Greg's Buttons is installed, theTypeBook will generate a font
  127.     error message, reporting "System Heap bit set: Font not loaded" for
  128.     the ".Cambridge" FOND.  This is nothing to be concerned about, and
  129.     you can disable theTypeBook's font error checking using its "Other
  130.     Options" dialog box (obtained by holding down the option key and
  131.     selecting the "File" menu).
  132.  
  133. MacWrite II
  134. -----------
  135. •  If the "Font" menu in MacWrite II freezes closed, you should remove the
  136.     "Claris Fonts" file in your system folder (possibly in a subfolder named
  137.     "Claris") to force MacWrite II to reconstruct its 'Font" menu the next
  138.     time you launch it. This is also a bug in MacWrite II.
  139.  
  140. Canvas
  141. -------
  142. •  When the "Substitute System Font" feature is enabled, some of the menu
  143.     items in Canvas may be "blurred" when you drag the mouse over them. To
  144.     remedy this problem, try switching to one of the other substitute system
  145.     fonts or turning off the "Substitute System Font" feature altogether.
  146.  
  147. America Online
  148. --------------
  149. •  I have heard that the buttons in AOL remain flat. This is not a bug in
  150.     Greg's Buttons. Rather, AOL bypasses the usual button routines in favor
  151.     of its own custom routines that look like the old style buttons while
  152.     behaving slightly differently when pushed. There is nothing I can do
  153.     about such applications that insist on using non-standard buttons.
  154.  
  155. Alarm Clock DA
  156. ---------------
  157. •  The Alarm Clock DA in System 7.0 does not work properly with the
  158.     substitute system fonts. Apple has fixed this problem in System 7.1.
  159.  
  160. WriteNow
  161. ----------
  162. •  If you try to use the Balloon Help for the Greg's Buttons control panel
  163.     while WriteNow 3.0 is running, you may encounter spurious help balloons
  164.     flashing on and off while you drag the mouse over Greg's Buttons. This
  165.     happens with any control panel, and it appears to be a bug in WriteNow.
  166.  
  167. Microsoft Graph
  168. ---------------
  169. •  The Microsoft Graph module seems to override the System 7 Color Buttons
  170.     feature.  As far as I can tell, MSGraph bypasses the standard button
  171.     drawing (and window dragging) routines in favor of its own, which look
  172.     and behave just like the standard ones. It also uses non-standard
  173.     windows without a close box, and it takes over a strip at the bottom of
  174.     the screen for a status bar. Why can't Microsoft do things the Apple way
  175.     like everybody else?
  176.  
  177. COMMENTS and FAQs (Frequently Asked Questions)
  178. ==============================================
  179. If Greg's Buttons causes problems on your Mac, try disabling its features
  180. one-by-one until the problem goes away. Most likely, the problem is caused
  181. by only one of the many features, and the rest of the features will work
  182. fine for you. In particular, any problem relating to dialog boxes is probably
  183. caused by the dialog box colorization feature, while a problem involving
  184. menus is most likely due to either the substitute system font or the menu
  185. colorization feature. The buttons themselves are exremely stable.
  186.  
  187. "Substitute System Font" Feature
  188. -------------------------------
  189. •  No, it is not possible to substitute an arbitrary font for the system font.
  190.     The font has to be tweaked rather significantly in order for it to work
  191.     reliably. If you have a pet font that you'd like to see added to the list of
  192.     alternate system fonts in Greg's Buttons, let me know via e-mail.
  193.  
  194. •  When you switch system fonts, the menus may not adjust to the new font
  195.     spacing immediately.  This will be fixed when the menu bar is redrawn.
  196.  
  197. •  Note that thin fonts such as "Helvetica 12" and "Palatino 12" will be
  198.     illegible when dimmed or grayed-out on a black and white monitor.
  199.  
  200. •  The "Palatino 14" substitute system font is a little to big to work well
  201.     as a system font.  Push buttons may appear cramped, and text might not
  202.     always fit properly in dialog boxes.  On the other hand, I think this font
  203.     looks great on large screens, and I am willing to ignore such glitches.
  204.  
  205. "Alerts and Dialog Boxes" Background Color Feature
  206. -----------------------------------------------
  207. •  Some applications assume that they are dealing with a black and white
  208.     dialog box while Greg's Buttons substitutes a color one. The difference is
  209.     enough to cause some odd behavior. There is no way to fix such conflicts
  210.     without rewriting parts of the offending applications. However, you can
  211.     specify applications to be excluded from this feature by clicking the 
  212.     "Exclude Applications..." button and adding the application to the exclusion
  213.     list.  The list includes Microsoft Word, Canvas, Help!, and Disk First Aid.
  214.  
  215.     IT IS NOT PHYSICALLY POSSIBLE FOR ME TO FIX THIS PROBLEM; IF IT WERE,
  216.     I WOULD HAVE FIXED IT BY NOW. THAT IS WHY I HAVE THE EXCLUSION LIST.
  217.  
  218. •  For some choices of the dialog box background color, the text insertion
  219.     cursor may be drawn in a just barely visible color.  This is the result of
  220.     the brain-dead routines the Mac uses to figure out a "suitable" inverse
  221.     (it thinks light yellow shows up well against a light gray, for instance).
  222.     To get around this, try changing the dialog box background color very
  223.     slightly, and the inverse routine may arbitrarily pick a better color.
  224.  
  225. •  When dialog colorization is turned on, you may notice that alert boxes
  226.     (the kind with the stop sign, caution, or note icon in the top-left corner)
  227.     are drawn with a grayed-out border.  This is a documented bug in the
  228.     system software, and Apple intends to fix it in a future release.
  229.  
  230. "Menu Bar and Menus" Color Feature
  231. --------------------------------
  232. •  If you have used another control panel (such as "Aurora" or "Kolor 2.0") to
  233.     color your menu bar, your previous menu color settings will override the
  234.     settings in the Greg's Buttons control panel.  If you want to use the menu
  235.     colorization feature in Greg's Buttons instead, use the other control panel
  236.     to set the menu colors back to black and white.  Greg's Buttons should then
  237.     remove the color information from the system file and substitute its own.
  238.  
  239. •  If your monitor is in 16-bit mode (thousands of colors) and you colorize
  240.     your menus, you may encounter gibberish in the menu bar when you launch
  241.     an application.  This is not a bug in Greg's Buttons (or Aurora or Kolor for
  242.     that matter), but rather a bug in the system software.
  243.  
  244. "Finder Window Color" Feature
  245. ----------------------------
  246. •  When you quit from an application that modifies the system color palette,
  247.     some Finder windows may be left with sploches of random colors in them.
  248.     This will go away as soon as the offending windows are re-drawn. This
  249.     annoyance is inherent to the system and there is nothing I can do about it.
  250.  
  251. "System 7 Color Buttons" Feature
  252. -------------------------------
  253. •  The third radio button dot style uses the highlight color that you can
  254.     select in the "Color" control panel.
  255.  
  256. •  Occasionally, you may find that push button titles are "fuzzy", "blocky"
  257.     or "blurred". This has been known to happen in Word, the HP DeskWriter
  258.     dialog box, and Alias Director. This problem will go away if you turn
  259.     off the "Embossed Push Button Text".
  260.  
  261. "Finder Mini-Icon" Colorization Feature
  262. ------------------------------------
  263. •  If you are using System 7.0, 7.0.1 or 7.1, then Greg's Buttons will
  264.     automatically colorize the mini icons (the smallest size you can select
  265.     in the "Views" control panel) in Finder lists. If you are using System 7
  266.     Pro or any version after System 7.1, then this feature will be disabled.
  267.     Nothing bad will happen; your mini-icons will just stay black and white.
  268.     I do not plan to re-implement this feature for future system versions.
  269.  
  270. •  Former versions of Greg's Buttons had a check box letting you turn this
  271.     feature on or off.  However, considering that the trap patch is relatively
  272.     innocuous and is already loaded into memory, I see no reason to disable it.
  273.  
  274. REGISTRATION
  275. ==============
  276. "Greg's Buttons" is SHAREWARE.  You may try it out for ten days. If after
  277. that time, you think it is a frivolous waste of processor time and disk
  278. space, just take a good look at your Mac without Greg's Buttons.  It will
  279. look dull, Dull, DULL!  If you want to keep it, you should complete the
  280. enclosed registration form and mail it to me with your shareware fee.
  281. My address, as well as information about methods of payment and site
  282. licenses, is given on the registration form.
  283.  
  284. You can also register online using CompuServe by typing "GO SWREG". The
  285. Registration ID for Greg's Buttons is 1277. After January 1, 1995, I will
  286. charge a 15% surcharge (making the fee $17.25) for registrations via
  287. CompuServe. This is to offset CompuServe's 15% processing fee (and also
  288. the fact that I don't actually see the money until 6 to 10 weeks after you
  289. register).
  290.  
  291. After Registering
  292. -----------------
  293. •  THERE ARE NO PASSWORDS, ENABLING CODES, OR REGISTRATION NUMBERS.
  294.     Once you have registered, you are entitled to feel good about yourself and
  295.     to turn off the "Annoying Shareware Message" check box. You will NOT get
  296.     any feedback from me to acknowledge receipt of your shareware payment.
  297.     I do read your comments, but I do not usually respond to hard copy mail.
  298.     Please do not worry whether I got your money. If you sent a check, you'll
  299.     find out from your bank, and if you sent cash, well, it's the thought that
  300.     counts, isn't it! Having paid once, you will never have to pay me anything
  301.     again, even if I add zillions of features and raise the shareware fee.
  302.  
  303. •  If you obtained this version from an online service, BBS, or User's Group,
  304.     then you should be able to obtain any and all new releases from the same
  305.     souce. If you got this version from a CD-ROM or bundled with a book, and
  306.     if you have no other way of acquiring the latest update, send me a politely
  307.     worded letter explaining your predicament. If the version you are using is
  308.     sufficiently out-of-date, I will eventually send you the most recent one.
  309.  
  310. •  Please do NOT mail me floppy disks or extra money and then complain that
  311.     I do not reply. I have plenty of disks, and whenever I send out updates they
  312.     are free. What I don't have is the time or resources to copy, label, package,
  313.     address, and mail hundreds of disks on a regular basis. I'm a mathematician,
  314.     not a commercial software publisher. What little time I devote to shareware
  315.     I feel is better spent coding than providing support. On the other hand, I
  316.     usually respond to e-mail (particularly on the internet) within 24 hours
  317.     unless I'm working on a paper or preparing for an exam.
  318.  
  319. DISTRIBUTION
  320. ==============
  321. This software is NOT in the public domain; rather it is Copyright ©1995 by
  322. Gregory D. Landweber. You may freely copy and distribute this software,
  323. provided that it you do not charge for it.  This software MAY be included in
  324. any disk or CD-ROM library of public domain and shareware software sold by
  325. a NON-PROFIT organization. This software MAY NOT be included in any
  326. commercial software collection sold for profit, nor may it be bundled with
  327. any commercial software, hardware, books, or other media without the
  328. prior written consent of the author. Whenever it is distributed, the "Greg's
  329. Buttons" control panel must be accompanied by this documentation file IN FULL.
  330.  
  331. DISCLAIMER
  332. ============
  333. The author, Gregory D. Landweber, makes no warranties, either express or
  334. implied, regarding the fitness of the "Greg's Buttons" control panel for any
  335. particular purpose. Use the "Greg's Buttons" control panel at your own risk.
  336. The author claims no liability for data loss or any other problems caused
  337. directly or indirectly by the "Greg's Buttons" control panel.